home *** CD-ROM | disk | FTP | other *** search
/ Honeybee: Hot Shareware / Honeybee Hot Shareware (Power Source, Inc.).iso / viewer / gifexe.doc < prev    next >
Text File  |  1991-09-22  |  11KB  |  299 lines
  1.  
  2.  
  3.  
  4.                            G I F E X E
  5.  
  6.                            Version 2.0
  7.                        September 20, 1991
  8.      
  9.           A Self-Displayer Program for Your GIF(tm) Pictures
  10.             Copyright 1990,1991 Steve Enns and Dan Magosse.
  11.                        All right reserved. 
  12.    
  13.      GIFEXE is produced by:
  14.  
  15.            Steve Enns                     Dan Magosse 
  16.         2425 Haultain Ave.             1321 14th St. East 
  17.           Saskatoon, Sk.                 Saskatoon, Sk. 
  18.           Canada S7J 1R2                 Canada S7H 0A6 
  19.  
  20.      Okay, here's the boring stuff, but don't worry, it's better
  21.      than chewing tinfoil:
  22.  
  23. ACKNOWLEDGEMENTS
  24.  
  25.      Kudos, thanks, and good karma to John Bridges for the
  26.      enlightening information and code contained in his VGAKIT
  27.      package.  Trademarks like GIF(tm) and PC(tm) are held by
  28.      their respective companies. 
  29.  
  30. DISCLAIMER
  31.  
  32.      The GIFEXE program is provided without warranty of any      
  33.      kind.  The user of the GIFEXE assumes complete              
  34.      responsibility for any and all incidental or consequential  
  35.      damages which may occur during normal or abnormal use of the
  36.      GIFEXE program.  Use the GIFEXE program at your own risk.
  37.  
  38. LICENSE 
  39.  
  40.      The entire GIFEXE package, including the GIFEXE program,
  41.      documentation, and sample files are Copyright 1990,1991
  42.      Steve Enns and Dan Magosse.  All rights reserved.  The      
  43.      unregistered shareware version of the GIFEXE may be freely
  44.      distributed to others by any means, as long the following
  45.      (three) conditions are met:
  46.  
  47.           1) GIFEXE is distributed in a "package" containing     
  48.           the following three files:
  49.                               GIFEXE.EXE
  50.                               GIFEXE.DOC
  51.                               GE-READ.ME
  52.           
  53.           2) GIFEXE is not distributed as part of any other      
  54.           product, except with specific written permission from
  55.           the authors.
  56.  
  57.           3) NO fee of any kind is charged for the GIFEXE        
  58.           package or for the service of providing the package,   
  59.           except Computer Bulletin Board Systems, which may      
  60.           distribute the GIFEXE package even though they may     
  61.           charge a membership or service fee.
  62.  
  63.      You can use this "shareware" version for as long as you
  64.      want, even until you're well into your nineties, but you are
  65.      of course encouraged to send us lots of money, too. (I'm
  66.      struggling to pay for my violin lessons, and Dan needs a new
  67.      fishing rod.)  If you send $8.00 U.S. or more to the "Steve
  68.      Enns" guy above, you will receive a 5.25" disk (NO 3.5"     
  69.      disks) with the latest registered version of GIFEXE, which  
  70.      has several additional "special effects" features. (See     
  71.      below.)  If you send $23.00 U.S. or more, you will also
  72.      receive registered versions of the following programs:
  73.  
  74.           GIFWARP!       Warp, bend stretch your GIFs for
  75.                          interesting effects.
  76.  
  77.           GIFCLIP        Clip/crop your GIFs, add text or your
  78.                          own GIF logo or signature.
  79.           
  80.           GIFSIZE        Resize all or part of your GIFs.  Shrink
  81.                          an entire screen to the size of an icon.
  82.  
  83.      (These programs are available in licensed SuperVGA versions
  84.      for $8.00 U.S. each, or get all three, and the latest
  85.      version of GIFEXE for $23.00 U.S. or more.)
  86.  
  87. REQUIREMENTS
  88.  
  89.           GIFEXE requires the following:
  90.  
  91.                -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer thing
  92.                -    About 280K of free RAM
  93.                -    DOS 3.0, 3.1, 3.2, 3.3, 4.0 (others untested)
  94.                -    A VGA or SuperVGA card
  95.  
  96.           and optionally:
  97.  
  98.                -    GIFEXE supports modes like 640x480, 800x600  
  99.                     with 256 colours on 512K and 1024K SuperVGA
  100.                     cards from ATI, Ahead, Cirrus, Chips and
  101.                     Technologies, Everex, OAK, Paradise, Trident,
  102.                     Tseng, Video7, Compaq, NCR, Genoa and VESA.
  103.  
  104. INSTALLATION
  105.  
  106.      Copy the GIFEXE program (and this helpful document of
  107.      course!) to any directory that you want - perhaps with      
  108.      your favourite GIF(tm) viewer somewhere in the DOS          
  109.      path.
  110.      
  111. USAGE
  112.  
  113.      Syntax for GIFEXE is as follows:
  114.  
  115.           GIFEXE [?] infilename[.GIF] [outfilename[.EXE]]
  116.                     /mode=0,1,2..  /autoscale
  117.      or
  118.  
  119.           GIFEXE [?] infilename[.GIF] [outfilename[.EXE]]
  120.                     /mode=0,1,2..  /autoscale  /fadein
  121.                     [ /fadeout | /dissolve ]  /delay=secs
  122.  
  123.      for the registered version.  The options may be used with
  124.      GIFEXE when you are creating an EXE, or with the EXE that
  125.      you have already created.  (See TUTORIAL below.)
  126.  
  127.      The options are as follows:
  128.  
  129.      /mode          /mode=0        Ordinary 320x200 mode
  130.                     /mode=1        Low resolution SVGA
  131.                                         640x400 or 640x350
  132.                                         depending on your card.
  133.                     /mode=2        Medium resolution 640x480
  134.                     /mode=3        High resolution 800x600 
  135.                     /mode=4        Higher resolution 1024x768
  136.                                         is supported on some
  137.                                         1024K cards.)
  138.                     
  139.      /autoscale     When this switch is used, the GIF will be
  140.                     scaled up to fit on the screen if the screen
  141.                     resolution is 2 or more times the resolution
  142.                     of the GIF.  (Just try it with a 320x200 GIF
  143.                     and a 640x480 screen mode.)
  144.  
  145.      And the additional registered version options:
  146.  
  147.      /fadein        Gradually fade in when displaying the GIF. 
  148.                     The screen will start black, and gradually
  149.                     the pictures will appear as the colors
  150.                     brighten.
  151.  
  152.      /fadeout       After the GIF has been displayed, and the 
  153.                     program is going to exit after a keypress,
  154.                     or a delay (see below) the screen will
  155.                     gradually fade to black.
  156.  
  157.      /dissolve      After the GIF has been displayed, and the
  158.                     program is going to exit, the pixels will
  159.                     randomly turn black until the entire picture
  160.                     is gone.
  161.  
  162.  
  163.      /delay=secs    After the GIF has been displayed, wait "secs"
  164.                     seconds before automatically exiting.  The
  165.                     program will also exit if a key is pressed
  166.                     before the time has expired.
  167.                                                        
  168.      For example, try:
  169.  
  170.           C> GIFEXE                to see the title screen
  171.  
  172.           C> GIFEXE ?              to see the help/brag screen
  173.  
  174.           C> GIFEXE house          to make the .EXE HOUSE.EXE
  175.                                    from the file HOUSE.GIF  
  176.  
  177.           C> GIFEXE house house2 /autoscale /fadein
  178.                                    make the .EXE file HOUSE2.EXE,
  179.                                    from the GIF(tm) HOUSE.GIF
  180.                                    using autoscale and fadein, so
  181.                                    that HOUSE2 will fadein and
  182.                                    autoscale when run. (/fadein
  183.                                    available on registered
  184.                                    versions only.)
  185.  
  186.           C> GIFEXE house /delay=10 
  187.                                    make an EXE, HOUSE.EXE which
  188.                                    will display HOUSE.GIF and
  189.                                    then wait 10 seconds before
  190.                                    exiting.
  191.  
  192. TUTORIAL
  193.  
  194.      (Nothin' to it!)
  195.  
  196.      Try out the following with your favourite GIF(tm) picture:
  197.  
  198.                C> GIFEXE picturename
  199.  
  200.      GIFEXE will prduce an EXE program with the name
  201.      "picturename.EXE"  That's it!   Now just run the program
  202.      you've just made:
  203.  
  204.                C> picturename
  205.  
  206.      The picture will be displayed on your screen in VGA, or in
  207.      SuperVGA if your computer has SuperVGA, and the picture
  208.      requires it.  If you want a small (VGA) picture to be
  209.      displayed in SuperVGA resolution, try:
  210.  
  211.                C> picturename /mode=2
  212.  
  213.      to display the picture in medium SuperVGA resolution.  If
  214.      you have the registered version, you can make an EXE that
  215.      will "fade in", and "dissolve out":
  216.  
  217.                C> GIFEXE picturename /fadein /dissolve 
  218.  
  219.      Now when you run picturename,
  220.  
  221.                C> picturename
  222.  
  223.      The picture will "fade in", wait for a keypress, and 
  224.      then "dissolve" and the program will exit.  And even if you
  225.      didn't use some options when you created picturename.EXE,
  226.      you can still use them later.  Try:
  227.  
  228.                C> picturename /delay=10 /mode=3
  229.  
  230.      and then the picture will "fade in" using mode 3, wait for
  231.      10 seconds or a keypress, and then "dissolve" and exit.
  232.  
  233.  
  234. HINTS
  235.  
  236.      - The EXEs produced by GIFEXE are handy for startup screens
  237.      on your computer, or title screens for your programs.
  238.  
  239.      - Its easy to make slide shows of GIFs by using a batch
  240.      file.  Just make a bunch of EXEs:
  241.  
  242.                C> GIFEXE pic1 /delay=4 /fadein
  243.  
  244.                C> GIFEXE pic2 /delay=4 
  245.  
  246.                C> GIFEXE pic3 /delay=4
  247.  
  248.                C> GIFEXE pic4 /delay=4 /fadeout
  249.  
  250.      and then a batch file to run them:
  251.  
  252.                C> copy con show.bat
  253.                pic1
  254.                pic2
  255.                pic3
  256.                pic4 
  257.                ^Z
  258.                
  259.                C> show
  260.  
  261. ERRORS
  262.  
  263.      - The following self explanatory error messages may be
  264.      produced by GIFEXE.  The errors involving the GIF(tm) files
  265.      will generally be due to disk errors or faulty image files. 
  266.      Other errors refer to lack of enough free RAM space, or lack
  267.      of required hardware (VGA).
  268.  
  269.           Can't initialize VGA graphics!
  270.           Unexpected EOF reading GIF!
  271.           Premature end of GIF!
  272.           Not GIF file!
  273.           Invalid GIF format
  274.           Error writing GIF!
  275.           Buffer allocation failure!
  276.           
  277. NOTES
  278.  
  279.      - GIFEXE reads both GIF87A standard (the original) and      
  280.      new GIF89A pictures, although most of the extensions in the
  281.      new GIF89A standard like (silly) text windows are ignored. 
  282.      The last image in multi-image GIFs will be the one displayed
  283.      by GIFEXE.
  284.  
  285.  
  286. HISTORY
  287.  
  288.      - Version 1.0 Completed June.1 1991
  289.      
  290.      - Version 1.2 Completed Sep.15 1991
  291.           Some additional cards now supported.  1024x768x256 now
  292.           supported on some 1024K cards.
  293.  
  294.      - Version 2.0 Completed Sep.20 1991
  295.           Registered version introduced with /fadein /fadeout
  296.           /dissolve /delay options.  /autoscale option           
  297.           added to both versions.
  298.  
  299.